home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 008 / grafpix.arc / GRAF-PIX.DOC < prev    next >
Encoding:
Text File  |  1986-11-09  |  10.8 KB  |  221 lines
  1.                             GRAF-PIX
  2.  
  3.                    A Graphics Creating Program 
  4.                         By Read G. Gilgen 
  5.                U. W. Labs for Recorded Instruction
  6.                Madison, WI  53706   (608) 262-1408
  7.                 (c) 1982 by the Board of Regents
  8.                  University of Wisconsin System
  9.  
  10. GRAF-PIX  is designed to help create graphic  designs,  pictures, 
  11. charts,  etc.  and  requires  little training on the part of  the 
  12. user.  The program uses straightforward commands to allow use  of 
  13. the  special  graphics commands available in the IBM-PC  Advanced 
  14. BASIC language.   Pictures can be saved on diskette,  edited, and 
  15. (with a graphics dump) be printed on a dot-matrix printer.
  16.  
  17. GRAF-PIX  may  be  copied and  distributed,  providing  that  the 
  18. copyright  information and credits are not changed.   Changes  in 
  19. the program may be made.  Suggestions or comments may be directed 
  20. to the author.
  21.  
  22. GRAF-PIX  requires one disk drive and the color-graphics  adapter 
  23. with at least a black & white monitor.   If you are interested in 
  24. color  illustrations as a final product,   use a high  resolution 
  25. color  monitor if possible.   If you use a low resolution   color  
  26. monitor, try GRAF-PIX.2X, which may avoid low resolution problems
  27. such  as loss of parts of the lines being created,   or  problems 
  28. with colors.   If you are primarily interested in printed  copies  
  29. of  your graphic illustrations,   the monitor will have no effect 
  30. on  the final product,  and a black and white monitor  (which  is 
  31. usually  high  resolution) may actually be preferable to  a   low 
  32. resolution color monitor.
  33.  
  34. PROCEDURES
  35.  
  36. 1.   Before beginning,  you should have the Graf-Pix program disk 
  37. and  another IBM-formatted diskette for storage of your  graphics 
  38. creations.
  39.  
  40. 2.  To begin the GRAF-PIX program, simply insert the program disk
  41. in drive A and turn the system on (or press CTRL-ALT-DEL).   In a 
  42. moment the program will appear and you will be asked to specify:
  43.  
  44.                1. Edit an existing graphics file
  45.                2. Create a new graphics file
  46.                3. Delete a graphics file
  47.                4. Print the Graf-Pix documentation
  48.                5. Exit from Graf-Pix
  49.   
  50. If  you have a picture on disk that you wish to edit,  make  sure 
  51. that the proper diskette is in drive "A" and press number 1.   If 
  52. you  want to create a new picture,  specify the filename (up to 8 
  53. characters)  and the extension ".grf" will be  added.   The  disk 
  54. that  will  hold  the  new picture should also  be  in  drive  A, 
  55. although nothing will be saved until later.
  56. 3.   Once  you have specified the picture file,  the screen  will 
  57. clear (if you are editing, the picture to be edited will appear),
  58. and you will be ready to begin.
  59.  
  60. The  pictures are created by using a cursor which moves in  eight 
  61. directions (up,  down,  left,  right,  and diagonally).  When you 
  62. begin,  the cursor is located in the center of the screen and can 
  63. be moved by pressing the cursor keys on the numeric keypad:
  64.  
  65.           Cursor Arrows = left, right, up, down 
  66.           Home          = up and left
  67.           PgUp          = up and right 
  68.           End           = down and left
  69.           PgDn          = down and right
  70.  
  71. As you move the cursor, a "rubber-band" line is created with each 
  72. move.  This tells you where the cursor began, and where you are 
  73. currently.  To erase the line, or to draw the line permanently, 
  74. you may use function keys F9 or F10 (explained below).
  75.  
  76. Several  keys  have  been designated to assist  in  the  graphics 
  77. creation process.  They are:
  78.  
  79.      F1  HELP       Press this key to see a list of function
  80.                     keys on the bottom line of the screen.
  81.                     Since  only  5 keys can be displayed  at 
  82.                     one time, you may press the F1 key again 
  83.                     for additional keys.  Press it again and
  84.                     and the list will be cleared from view.
  85.                     It is not necessary to display the HELP
  86.                     list in order to activate the function
  87.                     keys; they are active at all times while
  88.                     in the editing mode.     
  89.  
  90.      F2  CLR        Use this key to change the color of the
  91.                     line.  You may also follow the prompts and
  92.                     change the palette of colors available as
  93.                     well as the background color.  The lines
  94.                     and area colors are as follow:
  95.                       Palette 0: 1 Green  2 Red  3 Brown/Yellow
  96.                       Palette 1: 1 Cyan   2 Magenta  3 White
  97.                     Any background color from 0 to 15 may be 
  98.                     chosen.  0 is black, 1 is blue, 9 is bright
  99.                     blue, etc.  Some colors are not good for
  100.                     background, since lines and text can't be
  101.                     seen well with them.
  102.  
  103.                     NOTE:  Default colors are black background
  104.                     (Color 0) and palette 1, since these are the
  105.                     combinations which work best on all types of
  106.                     monitors.  If you have a low-resolution monitor,
  107.                     you will have particular problems with palette 0
  108.                     and with the vertical lines in palette 1.
  109.  
  110. \
  111.                     For example, vertical white lines are actually
  112.                     alternately red and blue, yet two such lines next
  113.                     to each other appear white.  
  114.  
  115.                     Also, angled or horizontal lines may appear to be
  116.                     producing every other dot, and some vertical lines
  117.                     may appear not to be producing anything at all.
  118.                     Nevertheless, all lines and dots are indeed being
  119.                     produced and will still function as borders for 
  120.                     filled areas
  121.  
  122.      F3 CIRCLE      This key allows you to create circles,
  123.                     using the current cursor position as the 
  124.                     center of the circle.  You will be prompted 
  125.                     on the bottom line for such information as 
  126.                     radius size, full or part circle, and normal, 
  127.                     tall, or flat aspect.  If you specifiy 
  128.                     partial circle, you will be asked for the 
  129.                     beginning and ending points.  Any number 
  130.                     between 0 and 2 may be entered for these 
  131.                     points, but the circle is drawn counter-
  132.                     clockwise beginning with the lower number and 
  133.                     ending with the higher number.  If you want 
  134.                     radius lines drawn, you may specify that too.
  135.  
  136.      F4 AREAFILL    This option allows you to fill in any enclosed 
  137.                     area with one of three colors from the current
  138.                     palette, plus the background color.  If the area
  139.                     is already filled with color 3 (white or brown/
  140.                     yellow) this option will have no effect.  The
  141.                     cursor must be within the area to be filled, and 
  142.                     there must be no holes in the boundaries, or 
  143.                     else the entire screen will be colored in!  
  144.                     Also, if you do not properly specify the boundary
  145.                     color, the entire scree may be colored in and
  146.                     the picture you are working on will be destroyed!
  147.                     The line color changes automatically to that of
  148.                     the filled area to make for easy exit from the
  149.                     area.  Line color may be changed with the F2 key
  150.                     (see above.)
  151.  
  152.      F5 TEXT        If you want to type text in your picture, 
  153.                     simply position the cursor just below where 
  154.                     you want to start, and press F5.  Then type 
  155.                     your text and press <ESC> or <ENTER> to 
  156.                     return to the graphics process.  Note that 
  157.                     you may only type on the one line that you 
  158.                     are on.  If you wish to type more than one 
  159.                     line, you must press <ESC>, reposition the 
  160.                     cursor, and press F5 again.  The graphics 
  161.                     cursor does not move while you enter text.
  162.  
  163.  
  164.  
  165. \
  166.      F6 BOX         You can make boxes by moving the cursor from 
  167.                     one corner of the box location diagonally to 
  168.                     the opposite corner, and then pressing F6.  
  169.                     You will then have the choice of a line box, 
  170.                     or a box filled with white (or brown/yellow).
  171.                     To fill a box with another color, draw the box
  172.                     alone, and then fill it with the F4 key option.
  173.  
  174.      F7 CURSOR      The "rubber-band" cursor normally moves six 
  175.                     dots at a time in the specified direction.  
  176.                     If you want to move only one dot at a time, 
  177.                     press F7.  If you want to resume with 6 dots 
  178.                     at a time, press F7 again.  Using this key one
  179.                     dot at a time can be very useful for filling in
  180.                     missing dots, for creating intricate details, or
  181.                     for "erasing" segments of your picture by moving
  182.                     the "rubber-band" line across it.
  183.  
  184.      F8 ENDPGM      This key allows you to end the program, by 
  185.                     letting you save the work you have done, 
  186.                     print the picture you are working on, or 
  187.                     ending without saving or printing anything.  
  188.                     If you accidentally hit F8, you may return to 
  189.                     the editor by pressing <ESC>.  The PRINT 
  190.                     option works only if you have a graphics 
  191.                     screen dump on the GRAF-PIX program disk. 
  192.                     When you select this option, it first saves 
  193.                     the picture, then send you to DOS to run your
  194.                     graphics dump.  You must reboot or (from DOS)
  195.                     type GP to return to the Graf-Pix program.
  196.  
  197.      F9 ERASE       This will be one of the most used keys, since 
  198.                     it erases the line being created by the 
  199.                     "rubber-band" cursor, and sets a new starting 
  200.                     point for the cursor.  This key allows you to 
  201.                     move the cursor to whereever you want to 
  202.                     create your graphics, text, etc.
  203.  
  204.      F10 LINE       If you want to draw the "rubber-band" line 
  205.                     permanently, then press F10.  The cursor then 
  206.                     begins where you left off and you can proceed 
  207.                     from there.  You may change the color of the line
  208.                     by using the F2 option before pressing this key.
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220. \
  221.